December, 1999

Installation Instructions for Cloudscape 3.0.1

Introduction

This message explains how to install Cloudscape 3.0.1 using the Java-based installation program. It provides example commands for a Korn shell/UNIX environment and for a Windows environment. Modify the example commands for your particular operating system. More information about installing and using Cloudscape on a variety of Java platforms can be found at: http://www.cloudscape.com/support/TechInfo/

Important Notice for Upgrades

To connect to a database created with a version of Cloudscape prior to 3.0, Cloudscape must upgrade that database. Upgrading involves writing changes to the system tables and so is not possible for databases on read-only media. Please read the user documentation for important information on upgrading your databases.

DO NOT INSTALL Cloudscape 3.0.1 on top of an existing pre-3.0.1 installation. Remove prior versions of the product by running the uninstall program, or manually removing the files. The uninstaller will not remove your databases.

Installation Instructions

You will need approximately 42MB of free disk space to install this edition.

Installation to a path containing spaces is not supported in Cloudscape 3.0.1.

Getting a JVM

In order to install Cloudscape 3.0.1 you must have a Java Virtual Machine (JVM) installed on your computer system. To learn how to acquire a JVM, visit JavaSoft's free download site at:

http://www.javasoft.com/

Installing with a Java 1.1.x JVM

Set PATH to point to the bin directory in your Java installation if not already set. For example:
- on a UNIX system (Korn shell):
```
export PATH=/usr/java1.1/bin:${PATH}
```
- on a Win32 system:
```
SET PATH=c:\jdk1.1.8\bin;%path%
```
Set class path to point to the classes.zip file in the JVM's lib directory. (Optional; on some platforms, the JVM may not require this step. Consult the documentation that came with your Java installation for specifics.) For example:
- on a UNIX system (Korn shell):
```
export CLASSPATH=/usr/java1.1/lib/classes.zip
```
- on a Win32 system:
```
SET CLASSPATH=c:\jdk1.1.8\lib\classes.zip
```
Copy the cloudscape.zip file to your local hard drive and run the installer by entering the command (or its equivalent for the JVM you are running), substituting the actual location of the file you downloaded for /tmp/downloads:
- on a UNIX system (Korn shell):
```
java -classpath ${CLASSPATH}:/tmp/downloads/cloudscape.zip install
```
- on a Win32 system:
```
java -classpath %CLASSPATH%;c:\downloads\cloudscape.zip install
```
When the installer's GUI window appears, it suggests a directory into which to install Cloudscape. On some systems such as UNIX, the default directory may be one for which you do not have write permission. Type in the path to a directory for which you have write permission. If you accept the default directory, the installer may not be able to complete.

Installing with a Java 1.2.x JVM

Although the Cloudscape product itself runs equally well in both JDK 1.1 and JDK 1.2 environments, the installer makes use of the Java 1 bootstrap loader to do its work.

Set PATH to point to the bin directory in your Java installation if not already set. For example:
- on a UNIX system (Korn shell):
```
export PATH=/usr/java1.2/bin:${PATH}
```
- on a Win32 system:
```
SET PATH=c:\jdk1.2.2\bin;%path%
```
Add cloudscape.zip to your class path before running the command, substituting the actual location of the file you downloaded for /tmp/downloads:
- on a UNIX system (Korn shell):
```
export CLASSPATH=/tmp/downloads/cloudscape.zip
```
- on a Win32 system:
```
SET CLASSPATH=c:\downloads\cloudscape.zip
```
Run the command, setting the bootclasspath to the cloudscape.zip file and to the rt.jar file in the JVM's lib directory, and substituting the actual location of the file you downloaded for /tmp/downloads:
- on a UNIX system (Korn shell):
```
java -Xbootclasspath:/usr/java1.2/jre/lib/rt.jar:/tmp/downloads/cloudscape.zip install
```
- on a Win32 system:
```
java -Xbootclasspath:c:\jdk1.2.2\jre\lib\rt.jar;c:\downloads\cloudscape.zip install
```
When the installer's GUI window appears, it suggests a directory into which to install Cloudscape. On some systems such as UNIX, the default directory may be one for which you do not have write permission. Type in the path to a directory for which you have write permission. If you accept the default directory, the installer may not be able to complete.

Release Notes

Once you've installed the product, please review the release_notes.html file carefully for important information. Also, you should review the book Getting Started with Cloudscape in the user documentation (accessible from the index.html page located in the directory into which you installed Cloudscape 3.0.1). This information is especially important in helping you understand how to get successfully started with Cloudscape 3.0.1.

Running on Sun Solaris

Solaris provides a default setting of 64 file descriptors for a session. Cloudscape (as do most database systems) requires more than 64 file descriptors to create or use a database. You can check the number of file descriptors currently available to you by running the following command from csh:

limit

If you find that you only have 64 file descriptors available, you can raise file descriptors to 1024 by running the following command:

unlimit

Help

If you have any questions or problems with the installation process, please contact:

installhelp@cloudscape.com